home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / TEX-UTIL / DVI_DVI1 / dvidvi / ReadMe < prev   
Text File  |  1996-01-24  |  5KB  |  128 lines
  1. DVIDVI L "March 1994"
  2. NAME
  3.  
  4. dvidvi \- selects and/or re-arranges pages in a TeX dvi file
  5. SYNOPSIS
  6.  
  7. dvidvi [param] infile outfile
  8. DESCRIPTION
  9. Copyright
  10. dvidvi 1.0, Copyright (C) 1988-91, Radical Eye Software
  11. Introduction
  12.  
  13. The dvidvi program converts a dvi file into another dvi file, with perhaps
  14. certain changes.
  15.  
  16. Parameters
  17.  
  18. -f n      page n is first page selected
  19.  
  20. -l n      page n is last page selected
  21.  
  22.  
  23. -n n      select at most n pages. Notice that n is the number of pages
  24. selected, independently of the number of pages actually
  25. contained in a sheet
  26.  
  27. -i { n1..n2 | n1 }[,...]
  28.  
  29. include pages (ranges allowed). When this option is
  30. used, ONLY the specified pages are selected. However,
  31. we can exclude from these pages with the option -x
  32.  
  33. -x { n1..n2 | n1 }[,...]
  34.  
  35. exclude pages (ranges allowed)
  36.  
  37. -q        work in quiet mode, that is do not print in the screen
  38. messages of how the work is being done.
  39.  
  40. -r        reverse the order of the pages.
  41.  
  42. The page numbers for the above options -f -l -i and -x can be specified
  43. in different ways.
  44.  
  45.  
  46. 1)  If a number n is given, it is interpreted as the n'th page from the
  47. begining of the .dvi file. Of course, this number is independent of the
  48. page number assigned by TeX.
  49.  
  50. 2)  TeX page numbers are those who are actually written in the page;
  51. these page numbers can be modified, for example, by using the TeX commands
  52. \\pagenumbering, \\setcounter{page}{n}, and \\addtocounter{page}{n}.
  53. A TeX page number can be specified by preceding the number n with the
  54. character @. Thus, if you specify -f @25 -l @30 you select the pages
  55. between 25 and 30, these numbers being those assigned by TeX.
  56.  
  57. 3)  However, several pages can have the same TeX page number in a .dvi file.
  58. For example, the introductory pages in a book are numbered i, ii, and so on
  59. until the first chapter begins and then, the pages are numbered 1, 2, etc.
  60. In this case, the pages numbered i and 1 in the .dvi file have the same TeX
  61. page number. If you want to select for example the second occurrence of the
  62. page numbered 1, you can specify a page number as (@2)1. Thus @1 is equivalent
  63. to (@1)1. For example, if you specify -f (@2)1 -l(@2)10 you select the pages
  64. between 1 and 10 of the first chapter, not the introductory pages between
  65. i and x.
  66.  
  67. There is another parameter that tells dvidvi how you want to change page
  68. layout and specifications.  This is the -m parameter.
  69.  
  70.  
  71. *   The number preceding the colon is the modulo value.  Everything will be
  72. done in chunks of pages this big.  If there is no colon, than the default
  73. value is assumed to be one.  The last chunk of pages is padded with as many
  74. blank pages as necessary.
  75.  
  76. *   Following the colon is a comma-separated list of page numbers.  These
  77. page numbers are with respect to the current chunk of pages, and must lie
  78. in the range zero to the modulo value less one.  If a negative sign
  79. precedes the number, then the page is taken from the mirror chunk; if there
  80. are m chunks, then the mirror chunk of chunk n is the chunk numbered m-n-1.
  81. Put simply, it is the chunk numbered the same, only from the end.  This can
  82. be used to reverse pages.  If no number is given, the page number defaults
  83. to 1.
  84.  
  85. *   Following each page number is an optional offset value in parenthesis,
  86. which consists of a pair of comma-separated dimensions.  Each dimension is
  87. a decimal number with an optional unit of measure.  The default unit of
  88. measure is inches, or the last unit of measure used.  All units are in true
  89. dimensions.  Allowable units of measure are the same that TeX allows: in,
  90. mm, cm, pt, pc, dd, and cc.
  91. EXAMPLES
  92.  
  93.  
  94.  
  95. -m -      Reverses the order of the pages.  This time, both the modulo and the
  96. page number are defaulted.
  97.  
  98. -m 2:0    Selects the first, third, fifth, etc. pages from the file.  Print
  99. this one after printing the next, taking the paper out of the
  100. feed tray and reinserting it into the paper feed.
  101.  
  102. -m 2:-1   Selects the second, fourth, etc. pages, and writes them in reverse
  103. order.
  104.  
  105. -m 4:-1,2(4.25in,0in)
  106.  
  107. -m 4:-3,0(4.25in,0in)
  108.  
  109. Useful for printing a little booklet, four pages to a sheet,
  110. double-sided, for stapling in the middle.  Print the first one,
  111. put the stack back into the printer upside down, and print the
  112. second.  The `in' specifications are superfluous.
  113.  
  114. -m ,(1pt,1)
  115.  
  116. Scare your system administrator!  Actually, things are so blurry with this
  117. option, you may want to send enemies letters printed like this.  *Long*
  118. letters.
  119.  
  120. -m 4:0(5.5in,4.25),3(0,4.25)
  121.  
  122. -m 4:1(0in,4.25),2(5.5,4.25)
  123.  
  124. Print a four-page card on one sheet.  Print the first, rotate the paper 180
  125. degrees and feed it again.  (PostScript people can do funny tricks with
  126. PostScript so this isn't necessary.)
  127.  
  128.